find

abstract fun find(text: String, consumer: Consumer<FindResult>)

Performs search of the given text, highlights all matches and selects the first match on the currently loaded web page.

Subsequent calls of this method with the same text select the next match.

If this method is invoked after stopFindingAndKeepSelection then the search will start from the last selected match, and if after stopFindingAndClearSelection then the search will start from the first match.

If the search is still in progress, but the page content is already changed, then the search result will be displayed for the new content of the page (different number of matches, and the next selected match).

The search is performed only through a visible content on the loaded web page. If some text is presented on the web page, but due to CSS rules it is not visible, the text finder will not check this content during search. Also, it does not find text on the web pages with an empty size, so make sure that the size of the browser instance where the text search is performed isn't empty.

Parameters

text

a text to search

consumer

a consumer object which allows obtaining the search result

Throws

when text is empty or blank

when the browser is closed


abstract fun find(text: String, options: FindOptions, consumer: Consumer<FindResult>)

Performs search of the given text with the given options, highlights all matches and selects the first or the last (depending on the given isSearchBackward flag) match on the currently loaded web page.

Subsequent calls of this method with the same text select the next or the previous match depending on the given isSearchBackward flag.

If this method is invoked after stopFindingAndKeepSelection then the search will start from the last selected match, and if after stopFindingAndClearSelection then the search will start from the first or the last match depending on the given isSearchBackward flag.

If the search is still in progress, but the page content is already changed, then the search result will be displayed for the new content of the page (different number of matches, and the next or the previous selected match).

The search is performed only through a visible content on the loaded web page. If some text is presented on the web page, but due to CSS rules it is not visible, the text finder will not check this content during search. Also, it does not find text on the web pages with an empty size, so make sure that the size of the browser instance where the text search is performed isn't empty.

Parameters

text

a text to search

options

the parameters such as direction and match case

consumer

a consumer object which allows obtaining the search result

Throws

when text is empty

when the browser is closed